package com.smart.community.work.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.smart.community.work.entity.CleaningAreaUserRel;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 保洁区域负责人关联Mapper接口
 * 
 * 严格按照《Java后端SpringBoot代码开发规范_重构版.md》Mapper规范实现：
 * - 继承BaseMapper：获得基础CRUD方法
 * - 方法命名：使用动词+名词形式，语义明确
 * - 参数注解：使用@Param注解标注参数
 * - 返回类型：使用具体的返回类型，避免使用Object
 * - 完整注释：所有方法都有完整的JavaDoc注释
 * - 数据访问封装：Mapper层负责所有数据库操作
 * - SQL优化：编写高效的SQL语句
 * - 参数映射：正确使用MyBatis参数映射
 * - 结果映射：正确使用MyBatis结果映射
 * 
 * @author Wu.Liang
 * @since 2025-01-30
 * @version 1.0.0
 */
@Mapper
public interface CleaningAreaUserRelMapper extends BaseMapper<CleaningAreaUserRel> {

    /**
     * 根据区域ID查询负责人关联列表
     * 
     * @param areaId 区域ID
     * @return 负责人关联列表
     */
    List<CleaningAreaUserRel> selectByAreaId(@Param("areaId") Long areaId);

    /**
     * 根据用户ID查询区域关联列表
     * 
     * @param userId 用户ID
     * @return 区域关联列表
     */
    List<CleaningAreaUserRel> selectByUserId(@Param("userId") Long userId);

    /**
     * 根据区域ID和用户ID查询关联记录
     * 
     * @param areaId 区域ID
     * @param userId 用户ID
     * @return 关联记录
     */
    CleaningAreaUserRel selectByAreaIdAndUserId(@Param("areaId") Long areaId, @Param("userId") Long userId);

    /**
     * 查询区域的主要负责人
     * 
     * @param areaId 区域ID
     * @return 主要负责人关联记录
     */
    CleaningAreaUserRel selectPrimaryByAreaId(@Param("areaId") Long areaId);

    /**
     * 查询用户负责的主要区域
     * 
     * @param userId 用户ID
     * @return 主要区域关联列表
     */
    List<CleaningAreaUserRel> selectPrimaryByUserId(@Param("userId") Long userId);

    /**
     * 批量插入区域用户关联
     * 
     * @param relations 关联记录列表
     * @return 插入数量
     */
    Integer batchInsert(@Param("relations") List<CleaningAreaUserRel> relations);

    /**
     * 更新主要负责人状态
     * 
     * @param areaId 区域ID
     * @param userId 用户ID
     * @param isPrimary 是否主要负责人
     * @return 更新数量
     */
    Integer updatePrimaryStatus(@Param("areaId") Long areaId,
                               @Param("userId") Long userId,
                               @Param("isPrimary") Integer isPrimary);

    /**
     * 根据区域ID删除所有关联记录
     * 
     * @param areaId 区域ID
     * @return 删除数量
     */
    Integer deleteByAreaId(@Param("areaId") Long areaId);

    /**
     * 根据用户ID删除所有关联记录
     * 
     * @param userId 用户ID
     * @return 删除数量
     */
    Integer deleteByUserId(@Param("userId") Long userId);

    /**
     * 根据区域ID和用户ID删除关联记录
     * 
     * @param areaId 区域ID
     * @param userId 用户ID
     * @return 删除数量
     */
    Integer deleteByAreaIdAndUserId(@Param("areaId") Long areaId, @Param("userId") Long userId);

    /**
     * 批量删除关联记录
     * 
     * @param areaIds 区域ID列表
     * @return 删除数量
     */
    Integer batchDeleteByAreaIds(@Param("areaIds") List<Long> areaIds);

    /**
     * 批量删除关联记录
     * 
     * @param userIds 用户ID列表
     * @return 删除数量
     */
    Integer batchDeleteByUserIds(@Param("userIds") List<Long> userIds);
}
